home *** CD-ROM | disk | FTP | other *** search
/ Aminet 35 / Aminet 35 (2000)(Schatztruhe)[!][Feb 2000].iso / Aminet / util / cli / fsearch.readme < prev    next >
Encoding:
Text File  |  2000-01-03  |  5.9 KB  |  179 lines
  1. Short:    Very fast search & list command - w/src
  2. Author:   dck@hol.gr (D. Keletsekis)
  3. Uploader: dck@hol.gr (D. Keletsekis)
  4. Version:  2.0
  5. Type:     util/cli
  6. Requires: WB 2.0+
  7.  
  8.  FSearch is a very fast, pure CLI command for searching
  9.  and/or listing of files.
  10.  
  11.  It uses the Boyer-Moore searching algorithm and has 
  12.  many options letting you drastically reduce the scope 
  13.  of the search and therefore make it even faster.
  14.  
  15.  ------------- Changes from last version ------------------
  16.  
  17.  Now the BYTE position of the text found will be printed, 
  18.  instead of the LINE number. This, because the Boyer-Moore 
  19.  search routine can not count linefeeds. You can still
  20.  get line numbers by giving the LINE switch (see below) 
  21.  but the search will become a little slower (still very 
  22.  fast though)
  23.  
  24.  -------------- Command Template --------------------------
  25.  
  26.  ROOT/A/M
  27.     Where to start searching from.
  28.     May be multiple root sources - with wild-cards
  29.     ex : FSearch ram: dh0:mydir#? all
  30.     List all files in all dirs in ram: and all
  31.     files in all dirs matching dh0:mydir#?
  32.  
  33.     This option must be given. 
  34.     All others are optional.        
  35.  
  36.  PAT/K
  37.     (string) File pattern to match
  38.     Only files meeting this pattern will be searched
  39.     ex : FSearch ram: pat=#?.info all
  40.     List all info files in ram: or it's sub-dirs
  41.  
  42.  TXT/K
  43.     (string) Text to search for.
  44.     If this option is not specified FSearch will act
  45.     like "list" and will not search the files.
  46.     ex : FSearch ram: txt="my name" all
  47.     Note: By default the search is case-insensitive.
  48.  
  49.  LINE/S
  50.     Will print out the line number of the text found.
  51.     This will slow down the search by about 10-20 %
  52.    because it will force fsearch to use a normal
  53.    sequential search instead.
  54.  
  55.    By default, the byte position of the text found
  56.    within its file will be printed (all this of
  57.    course, if you declare the verbose option)
  58.  
  59.  FROM/K
  60.     (date) Only search files FROM this date and up.
  61.     Dates must be written as dd-mm-yy.
  62.     ex : FSearch ram: from=07-08-96
  63.  
  64.  TO/K
  65.     (date) Only search files UP to this date
  66.  
  67.  MIN/N/K
  68.     (number) Only search files more than MIN Kb.
  69.     ex : FSearch ram: min=100 (look for files >= 100k)
  70.  
  71.  MAX/N/K
  72.     (number) Only search files less than MAX Kb.
  73.  
  74.  HEADER/K
  75.     (string) Only search files which have this header.
  76.     The Header specification may contain wild cards.
  77.     The first 100 bytes of the file will be loaded
  78.     and checked against this Header.
  79.     ex : FSearch ram: header=FORM????ILBM#? all
  80.     will list all iff pictures in ram:
  81.  
  82.  ALL/S
  83.     Recursively scan sub-directories
  84.  
  85.  CS=CASESENSITIVE/S      
  86.     Make the search case-sensitive
  87.  
  88.  V=VERBOSE/S
  89.     Print byte or LINE number & text of lines found.
  90.     The default is to just print the file name on the
  91.     first occurance of the TXT you're looking for.
  92.     With this option all the matches and their 
  93.     context will be displayed. If the line length is 
  94.     over 80 chars it will be clipped.
  95.  
  96.  NOBIN/S
  97.     Do not check binary files. Up to 100 bytes of the
  98.     file will be loaded and file will be skipped if
  99.     this header contains any non-ascii characters.
  100.  
  101.  HL=HIGHLIGHT/S
  102.     Highlight the search results
  103.  
  104.  INFO/S
  105.     Print file size/date/time next to it's name
  106.     No file paths are printed if this option is on.
  107.  
  108.  NOPATH/S
  109.     Print only the file name - not the full path.
  110.  
  111.  -------------- Installation ------------------------------
  112.  
  113.  Copy the FSearch binary to C: 
  114.  
  115.  If you also want the gui, copy the FSearch directory
  116.  anywhere and run the gui by clicking on the icon. You
  117.  must have Gui4Cli, of course - see below..
  118.  
  119.  -------------- The GUI -----------------------------------
  120.  
  121.  A great looking, resizable, multitasking GUI is also 
  122.  provided. Its in folder FSearch.
  123.  
  124.  This gui is independent of the command itself, so you 
  125.  can use it (or not) as you see fit. To run it you need 
  126.  the program "Gui4Cli" which you can download free from 
  127.  my site at http://users.hol.gr/~dck/gcmain.htm - v3.8+
  128.  
  129.  EXTRA : The Gui makes use of the program REP which is 
  130.  another fast CLI command for REPLACING text in files.
  131.  It must be in C:
  132.  
  133.  The gui will also allow you to copy, move, delete the
  134.  files found, or save out the file list. If you have the
  135.  CygnusEd editor and the CedBar gui, you can also load the 
  136.  files found and goto the line/byte automatically. The
  137.  CedBar gui, if you are interested, can be found on my
  138.  site or on aminet (search for "CedBar")
  139.  
  140.  -------------- Author ------------------------------------
  141.  
  142.  FSearch is FreeWare, but remains the Copyright of 
  143.  D.Keletsekis. No guarantees as to its performance or 
  144.  actions is made or implied. Use it at your own risk. 
  145.  
  146.  D. Keletsekis - dck@hol.gr
  147.  http://users.hol.gr/~dck
  148.  October 99
  149.  
  150.  
  151. ============================= Archive contents =============================
  152.  
  153. Original  Packed Ratio    Date     Time    Name
  154. -------- ------- ----- --------- --------  -------------
  155.     5716    3902 31.7% 14-Oct-99 10:59:16  FSearch
  156.      628     270 57.0% 16-Oct-99 10:54:42  FSearch_GUI.info
  157.     1451     597 58.8% 15-Oct-99 19:35:42 +FSearch.ed
  158.    16329    5265 67.7% 26-Oct-99 23:34:32 +FSearch.gc
  159.      388     170 56.1% 15-Oct-99 20:19:16 +FSearch.gc.info
  160.      330     228 30.9% 17-Jun-99 23:46:00 +Fsearch.pat
  161.      918     317 65.4% 15-Oct-99 19:34:28 +FSearch.pop
  162.     4591    2119 53.8% 16-Oct-99 11:56:06 +FSearch.readme
  163.      854     221 74.1% 15-Oct-99 20:19:16 +FSearch.readme.info
  164.     2820    1154 59.0% 23-Oct-99 13:45:14 +FSearch.rep
  165.     2968     866 70.8% 17-Jun-99 23:46:00 +FSearch.rmb
  166.     1110     488 56.0% 17-Jun-99 23:46:00 +Fsearch.types
  167.     4024    1472 63.4% 21-Jun-99 13:46:02 +bm.h
  168.    19178    6843 64.3% 14-Oct-99 11:05:16 +FSearch.c
  169.      331     141 57.4% 14-Oct-99 10:11:18 +fsearch_protos.h
  170.      110      81 26.3% 11-Jun-99 15:12:16 +SCOPTIONS
  171.      890     481 45.9% 16-Oct-99 12:00:16  ReadMe.NOW!
  172.      854     224 73.7% 16-Oct-99 10:54:42  ReadMe.NOW!.info
  173.     1484    1128 23.9% 16-Oct-99 12:05:50  Rep
  174.     6604    2416 63.4% 16-Oct-99 12:05:28 +rep.c
  175.     2608    1261 51.6% 16-Oct-99 10:38:22 +Rep.readme
  176.      120      85 29.1% 15-Jun-99 22:27:04 +SCOPTIONS
  177. -------- ------- ----- --------- --------
  178.    74306   29729 59.9% 04-Dec-99 12:26:54   22 files
  179.